Skip to content

Conversation

nginx-jack
Copy link
Contributor

@nginx-jack nginx-jack commented Aug 15, 2025

This is for the mainframe branch not main
Redocly: Match updated mainframe redocly usage

@nginx-jack nginx-jack requested a review from a team as a code owner August 15, 2025 13:00
@github-actions github-actions bot added documentation Improvements or additions to documentation product/nginx-one Issues related to NGINX One Console tooling Back end, repository, Hugo, and all things not related to content product/controller Issues related to NGINX Controller (EOS product) labels Aug 15, 2025
@nginx-jack
Copy link
Contributor Author

The hugo build will fail here, since it will be pointing at the wrong theme version. It is expected.

@mjang
Copy link
Contributor

mjang commented Aug 15, 2025

The hugo build will fail here, since it will be pointing at the wrong theme version. It is expected.

Question: does that explain this error? (I built against the mainframe branch)

Error: error building site: process: readAndProcessContent: "/Users/mi.jang/Repos/documentation/content/agent/installation-upgrade/container-environments/docker-images.md:80:1": failed to extract shortcode: template for shortcode "icon" not found
make: *** [watch] Error 1
➜  documentation git:(mainframe)

@nginx-jack
Copy link
Contributor Author

@mjang it needs the mainframe branch on documentation, and the mainframe branch from the hugo theme. I've made a preview build with thoss variables you can look at here - https://frontdoor-test-docs.nginx.com/previews/docs/bae0872/nginx-one/api/api-reference-guide/

@nginx-jack nginx-jack merged commit 77658e2 into mainframe Aug 18, 2025
11 of 12 checks passed
@nginx-jack nginx-jack deleted the redocly-shortcode-update branch August 18, 2025 10:02
nginx-jack added a commit that referenced this pull request Sep 2, 2025
* Fix catalog and home page

* Homepage: Match mainframe branch updates

* Homepage: Match mainframe css and layout setup

* Rewrite main landing page to be in markdown + updated card shortcode usage (#818)

feat: Rewrote main landing page to be in markdown + updated card shortcode usage

* Refactored icon usage to use new shortcode (#801)

* feat: Rewrote main landing page to be in markdown + updated card shortcode usage

* Update card params correctly

* chore: Refactored icon usage to use new shortcode

* Removed brand icons

* Removed final few brand icons

* Add overview of nginx-org source ingestion

* Update N1 landing page to use updated params

* Remove fa usages in mesh

* Redocly: Match updated mainframe redocly usage (#970)

* Update card-layout usage (#979)

* chore: Remove card-layout shortcode usage

* chore: Update NIC docs

* Remove NGINX Unit from home landing page (#981)

chore: Remove NGINX Unit from home landing page

* feat: Update tables

This commit updates tables across the NGINX documentation set by
removing the old bootstrap shortcode or replacing it with the new table
one. Mainframe has better sensible defaults, so the scaffolding provided
by the bootstrap shortcode is no longer necessary.

* Remove card-layout from N+ landing page (#996)

feat: Remove card-layout from N+ landing page

* Rebase: Fixes post rebase

* CardLayout: Fix post rebase

* fix: Icon for N4A on home landing page

* Fix: Missing line break after includes

* Fix OSSC page on mainframe (#1026)

fix: Render of ossc page + updated contents

* Remove sidebar partial (#1031)

chore: Remove sidebar partial

* Fix NMS rendering on mainframe (#1030)

fix: NMS rendering on mainframe

* Fix rn-style shortcode usage issues in build (#1032)

fix: Fix rn-style shortcode usage issues in build

* ProductSelector: Add yaml

* Mainframe: Cardlayout rebase for n1 workshop

* Mainframe: Update yaml

* Remove before-you-begin shortcode (#1036)

chore: Remove before-you-begin shortcode

* ProductSelector: Supply extUrl prop for external urls

* ProductSelector: Fix casing

* ProductSelector: Remove prefix /

* ProductSelector: Remove prefix /

* ProductSelector: Remove unit

---------

Co-authored-by: Lam <150060045+lamATnginx@users.noreply.github.com>
Co-authored-by: Lam Nguyen <la.nguyen@f5.com>
Co-authored-by: Alan Dooley <a.dooley@f5.com>
Co-authored-by: Michael McKeen <m.mckeen@f5.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation product/controller Issues related to NGINX Controller (EOS product) product/nginx-one Issues related to NGINX One Console tooling Back end, repository, Hugo, and all things not related to content
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants